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About this guide 



This guide provides information about configuring the HP Storage Works 
Auto Path for AIX software for supported HP disk arrays. 

Auto Path requires Hitachi Dynamic Link Manager fHDLM) software. 
This guide is a supplement to the Hitachi Dynamic Link Manager User 's 
Guide. 

Before installing Auto Path, refer to the readme file for instructions and 
restrictions. The procedures described in this guide and the readme file 
supersede the instructions provided in the Hitachi Dynamic Link Manager 
User's Guide. The GUI information in the Hitachi Dynamic Link Manager 
User's Guide does not apply. 

Intended audience 

This guide is intended for use by system administrators who have expertise 
with the associated systems and software and knowledge of these topics: 

• data processing concepts 

• disk arrays and RAID technology 

• operating system commands and utilities 

Disk arrays 

Unless otherwise noted, the term disk array refers to these disk arrays: 

HP Surestore Disk Array XP48 

HP Storage Works Disk Array XP128 

HP Surestore Disk Array XP256 

HP Surestore Disk Array XP512 

HP Storage Works Disk Array XP1024 

HP Storage Works XP 12000 Disk Array 

HP OpenView Continuous Access Storage Appliance (CASA) 
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Related documentation 



HP provides the following related documentation: 

• HP StorageWorks Disk Array XP128: Owner 's Guide 

• HP StorageWorks Disk Array XP1024: Owner's Guide 

• HP StorageWorks XP 12000 Disk Array Owner 's Guide 

• HP StorageWorks Command View XP for XP Disk Arrays: User Guide 

Refer to the manufacturer's documentation for information about operating 
system commands and third-party products. 

Conventions 

This guide uses the following text conventions. 

Figure 1 Blue text represents a cross-reference. The reference is 

linked to the target in the online version of this guide. 

www.hp.com Underlined, blue text represents a website on the 

Internet. The reference is linked to the target in the 
online version of this guide. 

literal Bold text represents application names, file names, 

menu items, dialog box titles, buttons, key names, field 
names, and values that you type exactly as shown. 

variable Italic type indicates that you must supply a value. Italic 

type is also used for manual titles. 

input /output Monospace font denotes user input and system 
responses, such as output and messages. 

Example The word "example" in italics denotes an example of 

input or output. 

[ ] Square brackets indicate an optional parameter. 

{ } Braces indicate that you must specify at least one of the 

listed options. 

I A vertical bar separates alternatives in a list of options. 
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Getting help 



If you still have a question after reading this guide, contact an HP 
authorized service provider or access our website: 

www.hp.com 

HP technical support 

In North America, call technical support at 1-800-652-6672, available 24 
hours a day, 7 days a week. 

Outside North America, call technical support at the nearest location. 
Telephone numbers for worldwide technical support are listed on the HP 
website under support: 

http://h1 8006. wwwl .hp.com/storage/arraysystems.html 

Be sure to have the following information available before calling: 

• technical support registration number (if applicable) 

• product serial numbers 

• product model names and numbers 

• applicable error messages 

• operating system type and revision level 

• detailed, specific questions 

For continuous quality improvement, calls may be recorded or monitored. 
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HP storage website 



Visit the support website for the most current information about HP 
StorageWorks XP products: 

http://hl 80Q6.www1 .hp.com/storage/arraysystems.html 

Consult your HP account representative for information about product 
availability, configuration, and connectivity. 



For the name of your nearest HP authorized reseller, you can obtain 
information by telephone: 



HP authorized reseller 



United States 
Canada 
Or contact: 



www.hp.com 



1-800-345-1518 
1-800-263-5868 
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Revision history 

January 2004 Minor update for product version 04.03 

August 2004 Update for version 04.40 

November 2004 Minor update for product version 04.40-/B 
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Warranty statement 



HP warrants that for a period of ninety calendar days from the date of 
purchase, as evidenced by a copy of the invoice, the media on which the 
Software is furnished (if any) will be free of defects in materials and 
workmanship under normal use. 

DISCLAIMER . EXCEPT FOR THE FOREGOING AND TO THE 
EXTENT ALLOWED BY LOCAL LAW, THIS SOFTWARE IS 
PROVIDED TO YOU "AS IS" WITHOUT WARRANTIES OF ANY 
KIND, WHETHER ORAL OR WRITTEN, EXPRESS OR IMPLIED. 
HP SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTIES 
OR CONDITIONS OF MERCHANTABILITY, SATISFACTORY 
QUALITY, NON-INFRINGEMENT, TITLE, ACCURACY OF 
INFORMATIONAL CONTENT, AND FITNESS FOR A 
PARTICULAR PURPOSE. Some jurisdictions do not allow exclusions of 
implied warranties or conditions, so the above exclusion may not apply to 
you to the extent prohibited by such local laws. You may have other rights 
that vary from country to country, state to state, or province to province. 

WARNING ! YOU EXPRESSLY ACKNOWLEDGE AND AGREE 
THAT USE OF THE SOFTWARE IS AT YOUR SOLE RISK. HP 

DOES NOT WARRANT THAT THE FUNCTIONS CONTAINED IN 
THE SOFTWARE WILL MEET YOUR REQUIREMENTS, OR THAT 
THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED, 
VIRUS -FREE OR ERROR-FREE, OR THAT DEFECTS IN THE 
SOFTWARE WILL BE CORRECTED. THE ENTIRE RISK AS TO THE 
RESULTS AND PERFORMANCE OF THE SOFTWARE IS ASSUMED 
BY YOU. HP DOES NOT WARRANT OR MAKE ANY 
REPRESENTATIONS REGARDING THE USE OR THE RESULTS OF 
THE USE OF THE SOFTWARE OR RELATED DOCUMENTATION IN 
TERMS OF THEIR CORRECTNESS, ACCURACY, RELIABILITY, 
CURRENTNESS, OR OTHERWISE. NO ORAL OR WRITTEN 
INFORMATION OR ADVICE GIVEN BY HP OR HP'S AUTHORIZED 
REPRESENTATIVES SHALL CREATE A WARRANTY. 
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LIMITATION OF LIABILITY . EXCEPT TO THE EXTENT 
PROHIBITED BY LOCAL LAW, IN NO EVENT INCLUDING 
NEGLIGENCE WILL HP OR ITS SUBSIDIARIES, AFFILIATES, 
DIRECTORS, OFFICERS, EMPLOYEES, AGENTS OR 
SUPPLIERS BE LIABLE FOR DIRECT, INDIRECT, SPECIAL, 
INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR OTHER 
DAMAGES (INCLUDING LOST PROFIT, LOST DATA, OR 
DOWNTIME COSTS), ARISING OUT OF THE USE, INABILITY 
TO USE, OR THE RESULTS OF USE OF THE SOFTWARE, 
WHETHER BASED IN WARRANTY, CONTRACT, TORT OR 
OTHER LEGAL THEORY, AND WHETHER OR NOT ADVISED 
OF THE POSSIBILITY OF SUCH DAMAGES. Your use of the 
Software is entirely at your own risk. Should the Software prove defective, 
you assume the entire cost of all service, repair or correction. Some 
jurisdictions do not allow the exclusion or limitation of liability for 
incidental or consequential damages, so the above limitation may not apply 
to you to the extent prohibited by such local laws. 

NOTE . EXCEPT TO THE EXTENT ALLOWED BY LOCAL LAW, 
THESE WARRANTY TERMS DO NOT EXCLUDE, RESTRICT OR 
MODIFY, AND ARE IN ADDITION TO, THE MANDATORY 
STATUTORY RIGHTS APPLICABLE TO THE LICENSE OF THE 
SOFTWARE TO YOU; PROVIDED . HOWEVER. THAT THE 
CONVENTION ON CONTRACTS FOR THE INTERNATIONAL 
SALE OF GOODS IS SPECIFICALLY DISCLAIMED AND SHALL 
NOT GOVERN OR APPLY TO THE SOFTWARE PROVIDED IN 
CONNECTION WITH THIS WARRANTY STATEMENT. 
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Installation 



This chapter describes how to install HP Storage Works Auto Path for AIX 
for use with HP disk arrays. 

Use these instructions instead of the procedures provided in the Hitachi 
Dynamic Link Manager User's Guide. 
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Installing Auto Path in AIX environments 



Before beginning installation, configure the AIX environment for Auto 
Path support, conforming to the following requirements: 

• Make sure you have a license key or a license file containing a license 
key. 

• After you create DLM devices, use only dim commands for these 
devices. Do not use standard operating system commands. For 
example, use /usr/DynamicLinkManager/bin/dlmmkvg instead of 
/usr/sbin/mkvg. 

• After creating a volume group on a DLM device, do not reference the 
underlying hdisk (as displayed with the lsdev command). 

Auto Path can be configured to issue an error when the underlying 
hdisk is referenced using the dlmodmset command. See the Hitachi 
Dynamic Link Manager User's Guide for more information. 

• Persistent reservation must be disabled when using Auto Path with a 
Continuous Access Storage Appliance (CASA). 

All paths to the same LUN must have the same type of HB A with identical 
firmware. 



Caution If you combine different types ofHBAs, Auto Path may not be able to switch 
the path when an error occurs. 



• Auto Path cannot be used to manage the boot disk. 

• Uninstall any versions of Auto Path older than 04.02 before installing 
the current software version. See "Upgrading to version 04.40-/B" on 
page 2 1 . 

• Auto Path cannot be used to manage command devices used by RAID 
Manager. 

Recommendation Use the same type of fiber switch for all paths. 
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System prerequisites for using the Auto Path software 

This version of Auto Path works with the AIX 4.3.3, AIX 5.1, and AIX 5.2 
operating systems. Refer to the Auto Path User's Guide or the readme file 
on the release media for minimum maintenance and patch levels required 
for Auto Path to operate properly. Additional patch level requirements 
apply if you also run HACMP and GPFS. 

Disk array firmware and software dependencies 

See the readme file on the Auto Path for AIX CD for firmware revision 
and software version requirements. 
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Installation procedure 



Configure the disk array LUNs to be accessible through at least one port in 
each cluster of the array — one port in CL1 and the other in CL2. 

Make the appropriate connections between the host HBAs and the disk 
array ports. 

Configure host bus adapters (HBAs) and switches. See the HBA product 
documentation for the configuration method and settings. Verify that the 
Fibre Channel connection method (such as Fabric or AL) matches the 
settings. 

The following setting must be made when using a Fibre Chennel switch 
with AIX 5.1 and AIX 5.2 operating systems. Do this for each Fibre 
Channel instance. 



Example chdev -1 fscsix -a f c_err_recover=f ast_f ail 

Note Do this before creating hdisk device definitions. Failover times can take up 
to 30 minutes if this setting is not made. 

Important Auto Path will not install if the above steps for connecting to an XP array 
are not completed and hdisk definitions representing XP LUNs are not 
present on the system. 

Install VisualAge C++ (version 5.0.0.0 or later) filesets on the host if 
required. AIX 4.3.3 software may be obtained at: 

http://www-l.ibm.com/support/docview.wss?org=SW&doc=4001173 

For AIX 5.1 and AIX 5.2, the software components are available on their 
respective install media. 

To install Auto Path: 

1 . Log in as root. 

2. If a license key file has been provided, save it as the following file: 
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/ var /tmp/hdlm_li cense 

Otherwise, enter the license key as follows: 

Create the /var/DLM directory: 

# mkdir /var/DLM 

Example # echo "123456789ABCDEF" > / var/DLM/ dim . lic_key 

where "123456789ABCDEF" is the license key number. 

Optional Use a text editor to enter the key in the /var/DLM/dlm.lic_key file. 

3. Insert the CD into the drive. 
There is no need to mount the CD. 

4. Execute the install command: 

# installp -aXgd /dev/cdO all 

Alternatively, you can specify the special file of the installation 
medium in place of /dev/cdO. 

5. Verify that the package was installed: 

# lslpp -L AutoPath.rte 

Verify that AutoPath.rte appears among the file set items in the 
output list and that its status is C (Commit). See the readme file on the 
Auto Path for AIX CD for the current level. 

( Optional) Add the PATH environment variable to the execution 
environment: 

#PATH=$PATH:/usr/DynamicLinkManager/bin 

# export PATH 

# set path=( $path /usr/DynamicLinkManager/bin ) 
If you want, you can edit the PATH statement in the root .profile. 



Bourne shell or 
Korn shell 

C shell 
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7. Define the physical volumes to be managed by Auto Path. 

If you want to let the DLM driver recognize all volumes that can be 
managed by the DLM driver, this step is unnecessary. Continue with 
step 9. 

To limit the volumes to be managed, you may either specify the 
volumes to be managed or specify the volumes you do not want 
managed. 

Example To specify the volumes to be managed, enter the logical names of 

these volumes (hdisks) in the configuration file: 

/usr/DynamicLinkManager/drv/dlmfdrv.conf 

Enter all hdisk references for paths to the same LUN. If only volumes 
hdisk5 and hdisk7 are used with Auto Path and reference paths to the 
same LUN, dlmfdrv.conf will contain the following: 

hdisk5 
hdisk7 

Note When booting from a Fibre Channel device, the boot device (usually 

hdiskO) must be placed in the dlmfdrv.unconf file or be configured so 
as to be excluded from Auto Path's control. 

Example To specify the volumes to not be managed, enter the logical names of 

these volumes (hdisks) in the unconf file: 

/usr/DynamicLinkManager/drv/dlmfdrv.unconf 

If physical volumes hdisk4 and hdisk6 are not to be recognized by the 
DLM driver, dlmfdrv.unconf will contain the following: 

hdisk4 
hdisk6 

If dlmfdrv.unconf and dlmfdrv.conf do not exist, the Auto Path 
configuration manager automatically creates the instances of the 
devices for all of the disks supported by Auto Path. 
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8. Execute the Auto Path configuration manager command: 

# dlmcfgmgr 

9. Verify that the Auto Path subsystem (DLMManager) is active: 

# lssrc -a I grep DLMManager 

A system reboot also activates the Auto Path subsystem. 

10. Verify that the Auto Path drivers (dlmfdrvrc) and alert driver (dlmadrv) 
are installed on an active kernel and available. 

Example # lsdev -C | grep dim 

dlmfdrvO Available HDLM Driver 
dlmadrv Available HDLM Alert Driver 

dlmfdrvl Available HDLM Driver 
dlmfdrvio Available HDLM Driver 

In this example: 

dlmadrv is the special file name of the Auto Path alert driver. 

dlmfdrvio is the driver instance for internally managing Auto Path. 

dlmfdrvO and dlmfdrvl are the special file names of Auto Path 
drivers. Each driver instance represents all paths to the same LU. The 
Auto Path driver name does not relate to the hdisk or LU names. The 
instances start with dlmfdrvO and increment sequentially. 

Verify that all Auto Path drivers representing the disk array LUNs you 
want recognized are displayed. If one or more drivers are not 
displayed, AIX error information is logged to the following file: 
/var/DynamicLinkManager/log/dlmcfgmgrl.log. For details about 
the log file, see the AIX documentation. 

1 1 . Create a volume group. 

To specify a physical volume group, specify the Auto Path device 
representing the LU. 

Example If hdisk4, hdisk5 and hdisk6 are in the same LU and represented by 

Auto Path device file dlmfdrvl: 

# dlmmkvg -s 32 -y dlmvgOl dlmfdrvl 
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Recommendation 



Example 



Use a SMIT Window for volume operations. For SMIT Window 
information see the Hitachi Dynamic Link Manager User's Guide. 

12. Verify the volume group: 
# dlmlsvg 

13. Create a file system. 

To create a file system having the size 8192000 at the mount point 
/tmp/dlmvg01_fs for the dlmvgOl volume group: 



# crfs -v jfs -g' dlmvgOl ' -a size= ' 8 1 92 0 0 0 ' 
-m ' /tmp/ dlmvg01_f s ' 

14. Make the mount point available. 



Example # mount /tmp/dlmvg01_f s 

15. Verify the mount point: 
#df-k 
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Upgrading to version 04.40-/B 



Recommendation Make a backup copy of data stored on the system before making changes 
(such as this upgrade) to the file systems. 

Be sure that all 04.40-/B prerequisite conditions are met before proceeding 
with the upgrade. 

Halt all activity with the file systems for the duration of the upgrade. 

Versions older than 04.02 must be uninstalled before you install version 
04.40. This includes removing the /opt/hitachi/HNTRLib files. Check the 
Auto Path for AIX User Guide for steps to uninstall the older version. 

For versions 04.02 or later, it is not necessary to uninstall the previous 
version of Auto Path. 



To upgrade: 

1. Unmount all Auto Path file systems. 

2. Deactivate all Auto Path (HDLM) volume groups. 

Example # dlmvaryoffvg dlmvgOl 

3. Save the dlmfdrv.conf or dlmfdrv.unconf file to a safe place. 

Example # cp /usr/DynamicLinkManager/drv/dlmf drv . conf /tmp 

4. Remove the Auto Path devices created with the previous version: 
# dlmrmdev 

5. Ensure that the fscsin attribute fc_err_recover is set to fast_fail. 

Perform the following steps if needed: 

a. This step removes the fscsi device and all of the hdisk definitions 
that are associated with this path. Record the LUN associations 
before proceeding so you can verify that the hdisk definitions 
correspond to the volume group definitions. 

# rmdev -1 fscsin -R 
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b. Change the attribute fc_err_recov of the parent device (fscsin) to 
fast_fail. 

# chdev -1 fscsin -a fc_err_recov=fast_fail 

c. Confirm that the setup of the parent device (fscsin) to fast_fail is 
effective. 

# lsattr -El fscsi/i 



Example fc_err_recov fast_fail FC Fabric Event Error 

RECOVERY Policy True 

6. Make sure the license key is in the /var/DLM/dlm.lic_key file, or a 
/var/tmp/hdlm_license file is present. 

Important Make a backup of this file. The version 04.40 installation will delete 

this file and the /var/DLM directory. 

7. Insert the Auto Path 04.40 CD into the drive. There is no need to mount 
the CD. 

8. Execute the install command: 

# installp -aXgd /dev/cdO all 

Alternately, you can specify the special file of the installation medium 
in place of /dev/cdO. 

9. Verify that the package was installed: 

# lslpp -L AutoPath.rte 

Verify that AutoPath.rte appears among the file set items in the 
output list and that its status is C (Commit). See the readme file on the 
Auto Path for AIX CD for the current level. 

10. Verify that the dlmfdrv.conf or dlmfdrv.unconf file is in the 
/usr/DynamicLinkManager/drv directory. 
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1 1 . Activate the Auto Path subsystem: 
# dlmcfgmgr 

A system reboot also activates the Auto Path subsystem 
(DLMManager). 

The dlmfdrv device files are regenerated as configured in the 
dlmfdrv.conf or dlmfdrv.unconf file. 

12. After verifying that hdisk to LUN associations are correct, activate all 
of the Auto Path (HDLM) volume groups. 



Example 



# dlmvaryonvg dlmvgOl 
Make the mount point available. 
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Example 



# mount /tmp/dlmvg01_f s 
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Operation 

This chapter provides information about Auto Path operations with HP disk 
arrays. 
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Setting the automatic failback feature using the 
dlnkmgr command 

Use the dlnkmgr command to set up automatic failback. 

dlnkmgr set -afb { on [-intvl Interval_Time] I off } [-s] 

The dlnkmgr command sets whether automatic failback is used for failed 
paths. The default setting is off. 

-afb Specify whether or not automatic failback is used for failed 
paths. 

on Automatic failback of the failed paths is performed at a specified 

interval. The recovered path is returned online. 

off Automatic failback is not performed. 

-intvl Specify the time interval for automatic failback with a value 
between 1 and 1440 (minutes). When no value is set for this 
parameter, the value previously set or 1 minute (default) is used 
for failback processing.When automatic failback is newly turned 
on, or the Auto Path manager is activated. The first automatic 
failback is performed after the duration interval specified. 

Settings on automatic failback remain after the system is turned off and 
restarted. The interval value is maintained even after automatic failback is 
turned off. The stored value is used when automatic failback is set on again 
and no value is set for the interval at that time. 

Only the paths containing an error are subject to the automatic failback 
operation. 

The paths reporting errors when the Auto Path manager is activated are also 
included in the automatic failback operation. 

With the addition of the automatic failback, only normal paths are subject 
to health check. 
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Error indication on the last path 



When the state of the paths is displayed with dlnkmgr view -path 

command, the last path for a device remains online. It does not go offline 
even if an error occurs. The path containing an error is now indicated as 
Online(E). 

• The Online(E) path returns online if input and output can be 
successfully executed. 

• The dlnkmgr online command or automatic fallback returns the 
Online(E) path online only. 

Using the dlnkmgr online command 

If -pathid is not specified in the dlnkmgr online operation, all the paths in 
hold state are subject to online processing. If there is a path that cannot be 
recovered, the following message is output: 

A path which failed to go online was detected during 
online operation of the KAPL01039-W DLM command. Do 
you want to continue the PathID = %d online 
operation? [y/n] ? Enter "y" to continue the 
operation, or "n" to abort it. 

When -s is specified, the operation is continued on the assumption that "y" 
is specified. 

You can execute the dlnkmgr view -path command to show the status of 
the LUN paths. 

# dlnkmgr view -path 

Identifying the Auto Path driver volumes 

To view the hdisks that belong to a dlmfdrv device, execute the following 
command: 

# dlnkmgr view -drv 
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Commands for operations with Auto Path volume groups 



Auto Path cannot use disks that are recognized by AIX unless you take 
some special measures. Auto Path provides utility commands for 
operations on Auto Path volume groups. 

A volume group created using the commands from Auto Path can be used 
only for Auto Path. The Auto Path utility commands for operations with 
Auto Path volume groups correspond to the commands executed in the 
SMIT screen "HDLM Volume Group." 

You can execute Auto Path volume group utility commands from the 
command line or in the SMIT screen. 

The format of each Auto Path utility command is the same as the format of 
the corresponding AIX command. The return values are the same as those 
of the corresponding AIX commands. 

The error messages and Help output for the commands from the Auto Path 
volume group utility commands are the same as those of the corresponding 
for AIX commands. 

If you perform volume group operations on Auto Path volume groups 
without using the Auto Path volume group utility commands, the volume 
group may become invalid. In this case, use AIX commands to correct this 
situation. (See the example.) 

Recommendation Use SMIT when you use the Auto Path volume group utility commands. 

When you use SMIT to select physical disks, SMIT displays only the first 
physical disk registered in ODM. This allows you to easily specify the 
physical disks allocated for Auto Path of the same LU, all at one time. 

Related information See the Hitachi Dynamic Link Manager User's Guide for the commands to 
be used on Auto Path (DLM) volume groups. 

A volume group managed by Auto Path must contain only dlmfdrvXX 
designations. Do not include an hdisk definition in an Auto Path volume 
group. 
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When you use an Auto Path volume group command, specify the AIX 
name (for example, hdiskl) as the physical volume name. However, after 
you have performed operations on the volume group, the volume name is 
changed to an Auto Path name (for example, dlmfdrvl). 

Do not specify any volume group other than a volume group created using 
the Auto Path volume group utility commands. Doing so may cause the 
volume group to become invalid. 

Example Create a volume group for Auto Path: 

# dlmmkvg -s 32 -y dlmvgl dlmfdrv2 dlmfdrv3 

# dlmlsvg 

Invalid volume group For a volume group used by Auto Path that includes an hdisk: 

# dlmlsvg -p dlmvgl 

dlmvgl : 

PV_NAME PV STATE TOTAL PPs FREE PPs FREE 
DISTRIBUTION 

dlmfdrv2 active 542 36 00 . . 00 . . 00 . . 00 . . 36 
dlmfdrv3 active 542 36 00 . . 00 . . 00 . . 00 . . 36 
hdisk4 active 542 36 00 . . 00 . . 00 . . 00 . . 36 

See the Hitachi Dynamic Link Manager User's Guide for commands to 
correct the condition, as well as the complete set of Auto Path (HDLM) 
volume group utility commands. 
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